home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / ARCHIVE / REZIPPR / REZIP.DOC < prev    next >
Encoding:
Text File  |  1991-07-13  |  14.3 KB  |  433 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.            Jonathan Richards' Intelligent Rezipper 2.0
  15.  
  16.                     Colony Computer Services
  17.                           P.O. Box 578
  18.                     Lindenhurst NY 11757-0578
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. How this manual is written.
  32. =============================
  33.  
  34.      I wrote this manual hoping you will read this while exploring
  35.      the rezipper.  If you do so, you will know the full workings
  36.      of the rezipper within 20 minutes.
  37.  
  38.      I will first give a short introduction of myself and what The
  39.      Intelligent Rezipper does.
  40.  
  41.      Following the introduction I will discuss on how to obtain
  42.      technical support and how to register the rezipper.
  43.  
  44.      I will then describe the details of each rezipper option in
  45.      the order it appears.
  46.  
  47.      Finally, I will briefly describe each menu option and how to
  48.      run the rezipper in a batch environment.
  49.  
  50.      
  51. What is The Intelligent Rezipper?
  52.  
  53.      The Intelligent Rezipper allows you to perform many different
  54.      tasks with or without re-compressing the files. The utility
  55.      allows you to scan for viruses, insert comments, delete files
  56.      within a zip file, change the zip file date to the highest in
  57.      the file, skip recompression on files with authenticity
  58.      checking, and rezip a zip file within a zip file. To perform
  59.      these tasks more quickly, the rezipper allows you to configure
  60.      a ram disk to use as its work drive.
  61.  
  62.      While developing this tool, I decided not to re-create the
  63.      wheel in many of its sections.  For instance, you could use
  64.      your favorite text editor to edit the file containing the list
  65.      of files to delete, and use your favorite file viewer to
  66.      display the various logs the rezipper generates. 
  67.  
  68.      I felt by allowing the user (and myself) to use their own file
  69.      viewer and editor they can take advantage of the respective
  70.      capabilities.
  71.  
  72.  
  73. Who is Jonathan Richards?
  74.  
  75.      As a hobby I entered the PC world about two years ago using a
  76.      386SX. For the past eight years I've been developing software
  77.      for the IBM system 34, 36 and AS/400 in RPG II and III. Now
  78.      using a 33mghz 64 cache I have expanded my horizons by self
  79.      teaching myself C language using the RIME mail network and
  80.      Compuserve as my teachers. 
  81.  
  82.      With the current recession, my employer of five years was
  83.      forced to change my employment status recently. Hopefully,
  84.      with my current savings and monies generating from this
  85.      utility, it will help me pay for my tuition and living
  86.      expenses so I can complete my Bachelor of Science Degree full
  87.      time.
  88.  
  89.  
  90. Limited Warranty
  91.  
  92.      Colony Computers Services warrants the same to be free of
  93.      defects in materials and workmanship for a period of 30 days
  94.      from the date of purchase. In no event shall Colony Computer
  95.      Services be liable for any loss of profit or any other
  96.      commercial damage, including but not limited to special,
  97.      incidental, consequential or other damages.
  98.  
  99.  
  100. Trademarks.
  101.  
  102. Compuserve is a registered trademark of CompuServe Incorporated.
  103. Borland C++ is a registered trademark of Borland International.
  104.  
  105. Registration
  106. --------------
  107.  
  108. You have a 10 day trial period. Once the trial period is over and
  109. you wish to continue using this utility, PLEASE send $15.00 to:
  110.  
  111.      Colony Computer Services
  112.      P.O. Box 578
  113.      Lindenhurst NY 11757-0578
  114.  
  115.  
  116. Technical Support and Updates
  117. -------------------------------
  118.  
  119. You may contact me by leaving a message on ICS BBS in the COLONY
  120. conference addressed to Jonathan Richards. Please do ask support
  121. from the sysop.  He is not employed by myself or Colony Computer
  122. Services.
  123.  
  124.      ICS BBS - Join Conference COLONY for support and updates.
  125.           516-226-3895 Hayes Compatible 2400
  126.           516-226-3989 Hayes Ultra 9600
  127.           516-226-3727 US Robotics 14.4
  128.  
  129. I can also be reached through the RIME Shareware Conference.
  130. Address the message to Jonathan Richards.
  131.  
  132. Configurating and Operating the Intelligent Rezipper
  133. ====================================================
  134.  
  135. Reset to the highest date?
  136. ----------------------------
  137.  
  138.      You may want to change the date of the zip file to reflect the
  139.      latest dated file stored in the zip file. Answer yes to change
  140.      the date or no to use todays date.
  141.  
  142.  
  143. Re-compress zip files?
  144. ------------------------
  145.  
  146.      The rezipper allows you to perform other functions without
  147.      actually "re-zipping" the file.  Answer yes if to fully rezip
  148.      the file.
  149.  
  150.  
  151. Delete files?
  152. ---------------
  153.  
  154.      The rezipper allows you to decide whether or not to delete
  155.      files at the time of processing. If you answer yes, you must
  156.      type in the full path name of the file that contains the list
  157.      of files to delete as specified under paths in the
  158.      configuration window.
  159.  
  160.  
  161. Rezip authenticity files?
  162. ---------------------------
  163.  
  164.      The rezipper can distinguish if a zip file contains
  165.      authenticity checking. You have the option not to recompress
  166.      these files. If you answer no, it will perform all other
  167.      functions other than recompression. If you answer yes, it
  168.      would processed as any other zip file, but the authenticity
  169.      checking will be lost.
  170.  
  171.  
  172. Scan for viruses
  173. ------------------
  174.  
  175.      The rezipper has the capability to scan a zip file for
  176.      viruses. If you answer yes to scan for viruses, you must
  177.      specify the full path name of the virus detection program in
  178.      the path section of the configuration window.
  179.  
  180.      Please note:  The rezipper has been designed to use McAfee
  181.      Associates Virus Scanner SCAN.EXE.  I can not guarantee any
  182.      other virus scanner will work.
  183.  
  184. Insert Comments?
  185. ------------------
  186.  
  187.      While processing a zip file, the rezipper can insert a zip
  188.      comment. If you answer yes to insert the comments, you must
  189.      specify the full path name of the file the contains the
  190.      comment in the path section of the configuration window.
  191.  
  192.  
  193. Run Debugger?
  194. ---------------
  195.  
  196.      For some unknown reason to you, you may have a problem with
  197.      the a particular zip file or the rezipper.  To help determine
  198.      what the problem is, you may turn on the debugger by answering
  199.      yes.
  200.  
  201.      When the debugger is on, it will output two additional logs to
  202.      assist you or I in determining the problem. The logs will
  203.      contain what you would normally see when running pkzip and
  204.      other additional information for my reference.
  205.  
  206.      If you feel the problem is a actual bug with the rezipper,
  207.      please upload these logs to me at ICS BBS, and if possible,
  208.      the zip file it was processing when the error occurred. 
  209.  
  210.      Please note:  When this option is turned on, the View Dos
  211.      option will not work.
  212.  
  213.  
  214. View Dos?
  215. -----------
  216.  
  217.      During processing, you have the option to observe pkzip,
  218.      pkunzip and scan.exe process each zip file.  Answer yes to
  219.      observe each processing stage.
  220.  
  221.  
  222. Work Drive Letter? (RAM/VDISK drive)
  223. --------------------------------------
  224.  
  225.      During processing the rezipper uses a specified drive as its
  226.      work drive. Even though the use of a ram drive is optional, a
  227.      work drive must be specified. I recommend using a drive with
  228.      at least of 2 megs of free space available. 
  229.  
  230.      Please note: You will see a significant improvement in speed
  231.      by using a RAM drive.
  232.  
  233. Alternate Drive Letter?
  234. -------------------------
  235.  
  236.      If by chance the rezipper finds that the first work drive does
  237.      not have enough space to process the zip file, it will use
  238.      this alternate drive. The alternate drive is optional and can
  239.      be left blank.
  240.  
  241.  
  242. Append Logs?
  243. --------------
  244.  
  245.      Unless you specify yes for append logs, the rezipper will
  246.      always erase the original log files before processing begins.
  247.      Specifying yes for append logs would be helpful when running
  248.      the rezipper multiple times from a batch file.
  249.  
  250.      Please note: Answering yes with the debugger on will continue
  251.      the growth of the debug logs, and eventually you will run out
  252.      of space.
  253.  
  254.  
  255. PATHS
  256. ==============
  257.  
  258. Directory to process
  259. ----------------------
  260.  
  261.      Specify the directory name where the zip files are for
  262.      processing.
  263.  
  264.  
  265. Path to Pkzip
  266. ---------------
  267.  
  268.      Specify the full path name of the directory where pkzip and
  269.      pkunzip can be found. 
  270.  
  271.  
  272. Virus Detection Program
  273. -------------------------
  274.  
  275.      Specify the full path name of the McAfee Associates virus
  276.      scanner (SCAN.EXE).  
  277.  
  278.  
  279. Comment file name
  280. -------------------
  281.  
  282.      Specify the full path name of the file that contains the zip
  283.      file comment.
  284.  
  285. Files to delete
  286. -----------------
  287.  
  288.      Specify the full path name of the ascii text file that
  289.      contains the list of file names to delete from the zip files.
  290.  
  291.  
  292. Name & path of file viewer
  293. ----------------------------
  294.  
  295.      You have the option to view any of the rezipper logs from
  296.      within the rezipper.  If you wish to do so, specify a file
  297.      viewing utility that will accept a file name as the first
  298.      parameter.
  299.  
  300.  
  301. Name & path of editor
  302. -----------------------
  303.  
  304.      You have the option to create and edit the text file that
  305.      contains a list of file names from within the rezipper.  If
  306.      you wish to do so, specify a editor that will accept a file
  307.      name as the first parameter.
  308.  
  309. Menu options
  310. ==============
  311.  
  312. Maintenance
  313. -------------
  314.  
  315.      Configure       -   Allows you to change any of the
  316.                          configuration options.
  317.  
  318.      Files to delete -   Create/Edit the ascii file specified in
  319.                          the path section of the configuration
  320.                          window. Enter the file names you wish to
  321.                          delete. Each file name must be on a line
  322.                          by itself.  The wildcards "*" and "?" may
  323.                          be used. Save the file before exiting
  324.                          your editor.
  325.  
  326. Processing
  327. ------------
  328.  
  329.      Rezip           -   A menu will appear and ask you for the
  330.                          directory that contains the zip files to
  331.                          process. Press enter or press the down
  332.                          arrow key while in the path field and the
  333.                          processing will begin.
  334.  
  335. View Logs
  336. -----------
  337.  
  338.      Processed       -   This log will contain a list of zip files
  339.                          that were successfully processed.
  340.                          Log file name: JrRezip.log
  341.  
  342.      Errors          -   This log will contain a list of zip files
  343.                          that had errors during processing. 
  344.                          Log file name: JrRezip.err
  345.  
  346.      Master Debug    -   This log will contain information sent by
  347.                          the rezipper, and error output sent by
  348.                          pkzip and the virus scanner.
  349.                          Log file name: JrRezip.dbg
  350.  
  351.      Dos Window      -   This logs will contain everything you
  352.                          would normally see when pkzip and scan
  353.                          are run normally.
  354.                          Log file name: JrRezip.db1
  355.  
  356. Quit
  357. -----
  358.  
  359.      Select this option when you want to exit the rezipper.
  360.  
  361. The Rezipper Command Line options
  362. ===================================
  363.  
  364.      Usage: Rezip [CONFIGFILE] [/RUN] [DIRECTORY]
  365.  
  366.      CONFIGFILE -   The name of the configuration file you want to
  367.                     create/edit or use.
  368.  
  369.      /RUN       -   Use this option to run the rezipper from a
  370.                     .bat file or the dos prompt. You must specify
  371.                     the configuration file when using this option.
  372.  
  373.      DIRECTORY  -   Type the name of a directory to process if you
  374.                     want to override the directory specified in
  375.                     the configuration file.
  376.  
  377. Comments:
  378. ===========
  379.  
  380.      The above feature allows you to create multiple configuration
  381.      files and to immediately start processing. This gives you the
  382.      capability to have separate configuration files for each
  383.      directory with a selection of different options!
  384.  
  385.          ----------------end-of-author's-documentation---------------
  386.  
  387.                          Software Library Information:
  388.  
  389.                     This disk copy provided as a service of
  390.  
  391.                            Public (software) Library
  392.  
  393.          We are not the authors of this program, nor are we associated
  394.          with the author in any way other than as a distributor of the
  395.          program in accordance with the author's terms of distribution.
  396.  
  397.          Please direct shareware payments and specific questions about
  398.          this program to the author of the program, whose name appears
  399.          elsewhere in  this documentation. If you have trouble getting
  400.          in touch with the author,  we will do whatever we can to help
  401.          you with your questions. All programs have been tested and do
  402.          run.  To report problems,  please use the form that is in the
  403.          file PROBLEM.DOC on many of our disks or in other written for-
  404.          mat with screen printouts, if possible.  PsL cannot debug pro-
  405.          programs over the telephone, though we can answer questions.
  406.  
  407.          Disks in the PsL are updated  monthly,  so if you did not get
  408.          this disk directly from the PsL, you should be aware that the
  409.          files in this set may no longer be the current versions. Also,
  410.          if you got this disk from another vendor and are having prob-
  411.          lems,  be aware that  some files may have become corrupted or
  412.          lost by that vendor. Get a current, working disk from PsL.
  413.  
  414.          For a copy of the latest monthly software library newsletter
  415.          and a list of the 3,000+ disks in the library, call or write
  416.  
  417.                            Public (software) Library
  418.                                P.O.Box 35705 - F
  419.                             Houston, TX 77235-5705
  420.  
  421.                                  Orders only:
  422.                                 1-800-2424-PSL
  423.                               MC/Visa/AmEx/Discover
  424.  
  425.                           Outside of U.S. or in Texas
  426.                           or for general information,
  427.                               Call 1-713-524-6394
  428.  
  429.                           PsL also has an outstanding
  430.                           catalog for the Macintosh.
  431.  
  432.  
  433.